ETSITS 129 198-4-1 vs.i.o 



(2002-09) 



Technical Specification 



Universal Mobile Telecommunications System (UMTS); 

Open Service Access (OSA) 
Application Programming Interface (API); 

Part 4: Call control; 

Subpart 1 : Common call control data definitions 

(3GPP TS 29.198-04-1 version 5.1.0 Release 5) 



3ji^ 




U 



3GPP TS 29.1 98-04-1 version 5.1 .0 Release 5 1 ETSI TS 1 29 1 98-4-1 V5.1 .0 (2002-09) 



Reference 



RTS/TSGN-05291 98-04-1 v510 
Keywords 



UMTS 



ETSI 

650 Route des Lucioles 
F-06921 Sophia Antipolis Cedex - FRANCE 

Tel. : +33 4 92 94 42 00 Fax: +33 4 93 65 47 1 6 

Siret N ° 348 623 562 0001 7 - NAF 742 C 
Association a but non lucratif enregistree a la 
Sous-Prefecture de Grasse (06) N° 7803/88 



Important notice 



Individual copies of the present document can be downloaded from: 
http://www.etsi.orq 

The present document may be made available in more than one electronic version or in print. In any case of existing or 

perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). 

In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive 

within ETSI Secretariat. 

Users of the present document should be aware that the document may be subject to revision or change of status. 

Information on the current status of this and other ETSI documents is available at 

http://portal.etsi.orq/tb/status/status.asp 

If you find errors in the present document, send your comment to: 
editor(5)etsi.fr 

Copyright Notification 

No part may be reproduced except as authorized by written permission. 
The copyright and the foregoing restriction extend to reproduction in all media. 

© European Telecommunications Standards Institute 2002. 
All rights reserved. 

DECT'^", PLUGTESTS™ and UMTS™ are Trade IVlarks of ETSI registered for the benefit of its IVIembers. 
TIPHON^" and the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members. 
2QppTM |g g jracle Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. 



ETSI 



3GPP TS 29.1 98-04-1 version 5.1 .0 Release 5 2 ETSI TS 1 29 1 98-4-1 V5.1 .0 (2002-09) 



Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under www.etsi.org/kev . 



ETSI 



3GPP TS 29.198-04-1 version 5.1.0 Release 5 



ETSI TS 129 198-4-1 V5.1.0 (2002-09) 



Contents 



Intellectual Property Rights 2 

Foreword 2 

Foreword 5 



Introduction . 



1 

2 

3 
3.1 

3.2 

4 
4.1 

4.2 



Scope 

References . 



Definitions and abbreviations. 

Definitions 

Abbreviations 



.7 

.7 

.7 
.1 



Call Control SCF 

Call Model Description 

Structure of Call Control SCF Documentation. 



5.1 

5.1.1 

5.1.2 

5.1.3 

5.1.4 

5.2 

5.2.1 

5.3 

5.3.1 

5.4 

5.4.1 

5.4.1.1 

5.4.1.2 



6.1 

6.2 

6.3 

6.4 

6.5 

6.6 

6.7 

6.8 

6.9 

6.10 

6.11 

6.12 

6.13 



14 
15 
16 
17 
18 
19 



6.20 
6.21 
6.22 
6.23 
6.24 



The Service Interface Specifications 9 

Interface Specification Format 9 

Interface Class 9 

Method descriptions 9 

Parameter descriptions 9 

State Model 9 

Base Interface 10 

Interface Class Iplnterface 10 

Service Interfaces 10 

Overview 10 

Generic Service Interface 10 

Interface Class IpService 10 

Method setCallbackO 10 

Method setCallbackWithSessionlDQ 11 

Common Call Control Data Types 11 

TpCallAlertingMechanism 11 

TpCallBearerService 12 

TpCallChargePlan 12 

TpCallPartyToChargeAdditionallnfo 12 

TpCallPartyToChargeType 13 

TpCallChargeOrder 13 

TpCallChargeOrderCategory 13 

TpCallEndedReport 13 

TpCallError 14 

TpCallAdditionalErrorlnfo 14 

TpCallErrorType 14 

TpCalllnfbReport 15 

TpCalllnfbType 15 

TpCallLoadControlMechanism 15 

TpCallLoadControlIntervalRate 16 

TpCallLoadControlMechanismType 16 

TpCallMonitorMode 16 

TpCallNetworkAccessType 16 

TpCallPartyCategory 17 

TpCallServiceCode 17 

TpCallServiceCodeSet 17 

TpCallServiceCodeType 17 

TpCallSuperviseReport 18 

TpCallSuperviseTreatment 18 



£75/ 



3GPP TS 29.198-04-1 version 5.1.0 Release 5 4 ETSI TS 129 198-4-1 V5.1.0 (2002-09) 

6.25 TpCallTeleService 19 

6.26 TpCallTreatment 19 

6.27 TpCallTreatmentType 20 

6.28 TpCallAdditionalTreatmentlnfo 20 

6.29 TpMediaType 20 

Annex A (normative): OMG IDL Description of Common Call Control Data Types 21 

Annex B (informative): W3C WSDL Description of Common Call Control Data Types 22 

Annex C (informative): Java API Description of the Call Control SCFs 23 

Annex D (informative): Change history 24 

History 26 



£75/ 



3GPP TS 29.198-04-1 version 5.1.0 Release 5 



ETSI TS 129 198-4-1 V5.1.0 (2002-09) 



Foreword 



This Technical Specification has been produced by the 3' Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 
where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



The present document is part 4, sub-part 1 of a multi-part TS covering the 3' Generation Partnership Project: Technical 
Specification Group Core Network; Open Service Access (OSA); Application Programming Interface (API), as 
identified below. The API specification (3GPP TS 29.198) is structured in the following Parts: 



Parti: 
Part 2: 
Part 3: 
Part 4: 



Parts 
Part 6 
Part? 
Parts 
Part 9 
Part 10 
Part 11 
Part 12 
Part 13 
Part 14 



"Overview"; 

"Common Data Definitions"; 

"Framework"; 

"Call Control"; 

Sub-part 1: "Call Control Common Definitions"; 

Sub-part 2: "Generic Call Control SCF"; 

Sub-part 3: "Multi-Party Call Control SCF"; 

Sub-part 4: "Multi-Media Call Control SCF"; 

Sub-part 5: "Conference Call Control SCF"; 

"User Interaction SCF"; 

"Mobility SCF"; 

"Terminal Capabihties SCF"; 

"Data Session Control SCF"; 

"Generic Messaging SCF"; 

"Connectivity Manager SCF"; 

"Account Management SCF"; 

"Charging SCF". 

"Policy Management SCF"; 

"Presence and Availability Management SCF"; 



(new in 3GPP Release 5) 

(new in 3GPP Release 5) 
(new in 3GPP Release 5) 
(new in 3GPP Release 5) 
(not part of 3GPP Release 5) 



(not part of 3GPP Release 5) 
(not part of 3GPP Release 5) 



(new in 3GPP Release 5) 
(new in 3GPP Release 5) 



The Mapping specification of the OSA APIs and network protocols (3GPP TR 29.998) is also structured as above. 
A mapping to network protocols is however not applicable for all Parts, but the numbering of Parts is kept. 
Also in case a Part is not supported in a Release, the numbering of the parts is maintained. 
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Table: Overview of the OSA APIs & Protocol Mappings 29.198 & 29.998-faniily 



OSA API specifications 29.198-family 


OSA API Mapping - 29.998-family 


29.198-01 


Overview 


29.998-01 


Overview 


29.198-02 


Common Data Definitions 


29.998-02 


Not Applicable 


29.198-03 


Framework 


29.998-03 


Not Applicable 


Call 
Control 

(CC) 
SCF 


29.198- 

04-1 

Common 

CC data 

definition 

s 


29.198- 
04-2 
Generic 
CCSCF 


29.198- 
04-3 
Multi- 
Party CC 
SCF 


29.198- 
04-4 
Multi- 
media CC 
SCF 


29.998-04-1 


Generic Call Control - CAP mapping 


29.998-04-2 


Generic Call Control — INAP mapping 


29.998-04-3 


Generic Call Control — Megaco mapping 


29.998-04-4 


Multiparty Call Control - SIP mapping 


29.198-05 


User Interaction SCF 


29.998-05-1 


User Interaction - CAP mapping 


29.998-05-2 


User Interaction - INAP mapping 


29.998-05-3 


User Interaction — Megaco mapping 


29.998-05-4 


User Interaction - SMS mapping 


29.198-06 


Mobility SCF 


29.998-06 


User Status and User Location - MAP mapping 


29.198-07 


Terminal Capabilities SCF 


29.998-07 


Not Applicable 


29.198-08 


Data Session Control SCF 


29.998-08 


Data Session Control - CAP mapping 


29.198-09 


Generic Messaging SCF 


29.998-09 


Not Applicable 


29.198-10 


Connectivity Manager SCF 


29.998-10 


Not Applicable 


29.198-11 


Account Management SCF 


29.998-11 


Not Applicable 


29.198-12 


Charging SCF 


29.998-12 


Not Applicable 


29.198-13 


Policy Management SCF 


29.998-13 


Not Applicable 


29.198-14 


Presence & Availability Management SCF 


29.998-14 


Not Applicable 



The present document is equivalent to ETSI ES 202 915-04-1 vl.1.1 (Parlay 4.0). 
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Scope 



The present document is Part 4, Sub-part 1 of the Stage 3 specification for an Apphcation Programming Interface (API) 
for Open Service Access (OSA). 

The OSA specifications define an architecture that enables application developers to make use of network functionality 
through an open standardised interface, i.e. the OSA APIs. The concepts and the functional architecture for the OSA are 
contained in 3GPP TS 23.127 [3]. The requirements for OSA are contained in 3GPP TS 22.127 [2]. 

The present document specifies the common definitions used by the Call Control Service Capability Features (SCF). 

This specification has been defined jointly between 3GPP TSG CN WG5, ETSI SPAN 12 and the Parlay Consortium, 
in co-operation with a number of JAJN"^ Community member companies. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 29.198-1 "Open Service Access; Application Programming Interface; Part 1: 

Overview" . 

[2] 3GPP TS 22.127: "Stage 1 Service Requirement for the Open Service Access (OSA) (Release 5)". 

[3] 3GPP TS 23.127: "Virtual Home Environment (Release 5)". 

[4] 3GPP TS 22.002: "Circuit Bearer Services Supported by a PLMN". 

[5] ISO 4217 (1995): "Codes for the representation of currencies and funds ". 

[6] 3GPP TS 24.002: "GSM-UMTS PubHc Land Mobile Network (PLMN) Access Reference 

Configuration". 

[7] 3GPP TS 22.003: "Circuit Teleservices supported by a Public Land Mobile Network (PLMN)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 29.198-1 [1] apply. 
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3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TS 29.198-1 [1] apply. 

4 Call Control SCF 

Three flavours of Call Control (CC) APIs have been included in 3GPP Release 5. These are the Generic Call Control 
(GCC), the Multi-Party Call Control (MPCC) and the Multi-Media Call Control (MMCC). The GCC is the same API as 
was already present in the Release 99 specification (TS 29.198 v3.3.0). Multi-Party Call Contorl was introduced in the 
Release 4 specifications, and Multi-Media Call Control is introduced in Release 5. 

The joint work between 3GPP CN5, ETSI SPAN12 and the Parlay CC Working group with collaboration from JAIN 
has been focussed on the MPCC and MMCC APIs. A number of improvements on CC functionality have been made 
and are reflected in these APIs. For this it was necessary to break the inheritance that previously existed between GCC 
and MPCC. 

The joint CC group has furthermore decided that the MPCC is to be considered as the future base CC family and the 
technical work will not be continued on GCC. Errors or technical flaws will of course be corrected. 

4.1 Call Model Description 

The call model used for the Call Control SCFs has the following objects. 

* a call object. A call is a relation between a number of parties. The call object relates to the entire call view from the 
application. E.g., the entire call will be released when a release is called on the call. Note that different applications can 
have different views on the same physical call, e.g., one application for the originating side and another application for 
the terminating side. The applications will not be aware of each other, all 'communication' between the applications will 
be by means of network signalling. The API currently does not specify any feature interaction mechanisms. 

* a call leg object. The leg object represents a logical association between a call and an address. The relationship 
includes at least the signalling relation with the party. The relation with the address is only made when the leg is routed. 
Before that the leg object is IDLE and not yet associated with the address. 

* an address. The address logically represents a party in the call. 

* a terminal. A terminal is the end-point of the signalling and/or media for a party. This object type is currently not 
addressed. 

The call object is used to establish a relation between a number of parties by creating a leg for each party within the 
call. 

Associated with the signalling relationship represented by the call leg, there may also be a bearer connection (e.g., in the 
traditional voice only networks) or a number (zero or more) of media channels (in multi-media networks). 

A leg can be attached to the call or detached from the call. When the leg is attached, this means that media or bearer 
channels related to the legs are connected to the media or bearer channels of the other legs that are attached to the same 
call. I.e., only legs that are attached can 'speak' to each other. A leg can have a number of states, depending on the 
signalling received from or sent to the party associated with the leg. Usually there is a limit to the number of legs that 
are in being routed (i.e., the connection is being established) or connected to the call (i.e., the connection is established). 
Also, there usually is a limit to the number of legs that can be simultaneously attached to the same call. 

Some networks distinguish between controlling and passive legs. By definition the call will be released when the 
controlling leg is released. All other legs are called passive legs. There can be at most one controlling leg per call. 
However, there is currently no way the application can influence whether a Leg is controlling or not. 

There are two ways for an application to get the control of a call. The application can request to be notified of calls that 
meet certain criteria. When a call occurs in the network that meets these criteria, the application is notified and can 
control the call. Some legs will already be associated with the call in this case. Another way is to create a new call from 
the application. 
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4.2 Structure of Call Control SCF Documentation 

Each of the Call Control SCFs is specified under the following headings: 

• The Sequence diagrams give the reader a practical idea of how each of the SCF is implemented. 

• The Class relationships clause shows how each of the interfaces applicable to the SCF, relate to one another. 

• The Interface specification clause describes in detail each of the interfaces shown within the Class diagram part. 

• The State Transition Diagrams (STD) show transition between states in the SCF. The states and transitions are 
well-defined; either methods specified in the Interface specification or events occurring in the underlying networks 
cause state transitions. 

• The Data definitions clause show a detailed expansion of each of the data types associated with the methods within 
the classes. Note that some data types are used in other methods and classes and are therefore defined within the 
Common Data types part of this specification (TS 29.198-2). 

An implementation of one of the call control APIs which supports or implements a method described in one of the sub- 
parts of TS 29.198-04, shall support or implement the functionality described for that method, for at least one valid set 
of values for the parameters of that method. Where a method is not supported by an implementation of a Service 
interface, the exception P_METHOD_NOT_SUPPORTED shall be returned to any call of that method. 



5 The Service Interface Specifications 

5.1 Interface Specification Format 

This clause defines the interfaces, methods and parameters that form a part of the API specification. The Unified 
Modelling Language (UML) is used to specify the interface classes. The general format of an interface specification is 
described below. 

5.1.1 Interface Class 

This shows a UML interface class description of the methods supported by that interface, and the relevant parameters 
and types. The Service and Framework interfaces for enterprise-based client applications are denoted by classes with 
name Ip<name>. The callback interfaces to the applications are denoted by classes with name IpApp<name>. For 
the interfaces between a Service and the Framework, the Service interfaces are typically denoted by classes with name 
IpSvc<name>, while the Framework interfaces are denoted by classes with name IpFw<name> 

5.1.2 Method descriptions 

Each method (API method "call") is described. Both synchronous and asynchronous methods are used in the API. 
Asynchronous methods are identified by a 'Req' suffix for a method request, and, if applicable, are served by 
asynchronous methods identified by either a 'Res' or 'Err' suffix for method results and errors, respectively. To handle 
responses and reports, the application or service developer must implement the relevant IpApp<name> or 
IpSvc<name> interfaces to provide the callback mechanism. 



5.1.3 Parameter descriptions 



Each method parameter and its possible values are described. Parameters described as 'in' represent those that must have 
a value when the method is called. Those described as 'out' are those that contain the return result of the method when 
the method returns. 

5.1.4 State IVIodel 

If relevant, a state model is shown to illustrate the states of the objects that implement the described interface. 
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5.2 Base Interface 

5.2.1 Interface Class Iplnterface 

All application, framework and service interfaces inherit from the following interface. This API Base Interface does not 
provide any additional methods. 



«lnterface» 
Iplnterface 



5.3 Service Interfaces 
5.3.1 Overview 

The Service Interfaces provide the interfaces into the capabilities of the underlying network - such as call control, user 
interaction, messaging, mobility and connectivity management. 

The interfaces that are implemented by the services are denoted as 'Service Interface'. The corresponding interfaces that 
must be implemented by the application (e.g. for API callbacks) are denoted as 'Application Interface'. 

5.4 Generic Service Interface 
5.4.1 Interface Class IpService 

Inherits from: Iplnterface 

All service interfaces inherit from the following interface. 



«lnterface» 
IpService 



setCallback (applnterface : in IplnterfaceRef) : void 

setCallbackWitlnSessionlD (applnterface : in IplnterfaceRef, sessionID : in TpSessionID) : void 



5.4.1.1 Method setCallback() 

This method specifies the reference address of the callback interface that a service uses to invoke methods on the 
application. It is not allowed to invoke this method on an interface that uses SessionlDs. 

Parameters 

applnterface : in IplnterfaceRef 

Specifies a reference to the application interface, which is used for callbacks 
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Raises 

TpCommonExceptions , P_INVALID_INTERFACE_TYPE 



5.4.1.2 Method setCallbackWithSessionlD() 

This method specifies the reference address of the application's callback interface that a service uses for interactions 
associated with a specific session ID: e.g. a specific call, or call leg. It is not allowed to invoke this method on an 
interface that does not use SessionlDs. 

Parameters 

applnterface : in IpInterfaceRef 

Specifies a reference to the application interface, which is used for callbacks 

sessionID : in TpSessionID 

Specifies the session for which the service can invoke the application's callback interface. 

Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_INTERFACE_TYPE 



6 Common Call Control Data Types 

The following data types referenced in this clause are defined in 3GPP TS 29.198-5: 

TpUIInfo 

All other data types referenced but not defined in this clause are common data definitions which may be found in 
3GPPTS 29.198-2. 



6.1 TpCallAlertingMechanism 



This data type is identical to a Tplnt32 , and defines the mechanism that will be used to alert a call party. The values 
of this data type are operator specific. 
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6.2 TpCallBearerService 



This data type defines the type of call application-related specific information (Q.93 1 : Information Transfer Capability, 
and 3G TS 22.002) 



Name 


Value 


Description 


P_CALL_BEARER_SERVICE_UNKNOWN 





Bearer capability information unlcnown at tliis time 


P_CALL_BEARER_SERVICE_SPEECH 


1 


Speech 


P_CALL_BEARER_SERVI CE_D I G I TALUNRE STRI CTED 


2 


Unrestricted digital information 


P_CALL_BEARER_SERVICE_DIGITALRESTRICTED 


3 


Restricted digital information 


P_CALL_BEARER_SERVICE_AUDIO 


4 


3,1 kHz audio 


P_CALL_BEARER_SERVICE_DIGITALUNRESTRICTED 
TONES 


5 


Unrestricted digital information with tones/announcements 


P_CALL_BEARER_SERVICE_VIDEO 


6 


Video 



6.3 TpCallChargePlan 



Defines the Sequence of Data Elements that specify the charge plan for the call. 



Sequence Element Name 


Sequence Element Type 


Description 


Char geOrder Type 


TpCallChargeOrderCategory 


Charge order 


Transparent Charge 


TpOctetSet 


Operator specific charge plan specification, e.g. 

charging table name / charging table entry. The 

associated charge plan data will be send 

transparently to the charging records. 

Only applicable when transparent charging is 
selected. 


ChargePlan 


Tplnt32 


Pre-defined charge plan. Example of the charge 

plan set from which the apphcation can choose 

could be : (0 = normal user, 1 = silver card user, 

2 = gold card user). 

Only applicable when transparent charging is 
selected. 


AdditionalTnf o 


TpOctetSet 


Descriptive string which is sent to the billing 

system without prior evaluation. Could be 

included in the ticket. 


PartyToCharge 


TpCallPartyToChargeType 


Identifies the entity or party to be charged for the 
call or call leg. 


Party ToChargeAdditional Info 


TpCallPartyToChargeAdditionallnfo 


Contains additional information regarding the 
charged party. 



6.4 TpCallPartyToChargeAdditionallnfo 

Defines the Tagged Choice of Data Elements that identifies the entity or party to be charged. 





Tag Element Type 








TpCallPartyToChargeType 







Tag Element Value 


Choice Element 
Type 


Choice Element Name 


P_CALL_PARTY_ORIGINATING, , 


NULL 


Undefined 


P_CALL_PARTY_DESTINATION, 


NULL 


Undefined 


P_CALL_PARTY_SPECIAL 


TpAddress 


CallPartySpecial 
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6.5 TpCallPartyToChargeType 

Defines the type of call party to charge 



Name 


Value 


Description 


P_CALL_PARTY_ORIGINATING 





Calling party, i.e. party that initiated the call. For application initiated calls this 
indicates the first party of the call 


P_CALL_PARTY_DESTINATION 


1 


Called party 


P_CALL_PARTY_SPECIAL 


2 


An address identifying e.g. a third party, a service provider 



6.6 TpCallChargeOrder 



Defines the Tagged Choice of Data Elements that specify the charge plan for the call. 





Tag Element Type 






TpCallChargeOrder Category 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CALL_CHARGE_TRANSPARENT 


TpOctetSet 


Transparent Charge 


P_CALL_CHARGE_PREDEFINED_SET 


Tplnt32 


ChargePlan 



6.7 TpCallChargeOrderCategory 

Defines the type of charging to be applied 



Name 


Value 


Description 


P_CALL_CHARGE_TRANSPARENT 





Operator specific charge plan specification, e.g. charging table name / 

charging table entry. The associated charge plan data will be send 

transparently to the charging records 


P_CALL_CHARGE_PREDEFINED_SET 


1 


Pre-defined charge plan. Example of the charge plan set from which the 

application can choose could be : (0 = normal user, 1 = silver card user, 2 = 

gold card user). 



6.8 TpCallEndedReport 



Defines the Sequence of Data Elements that specify the reason for the call ending. 



Sequence Element Name 


Sequence Element Type 


Description 


CallLegSessionID 


TpSessionID 


The leg that initiated the release of the call. 

If the call release was not initiated by the leg, 
then this value is set to -1. 


Cause 


TpReleaseCause 


The cause of the call ending. 
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6.9 TpCallError 



Defines the Sequence of Data Elements that specify the additional information relating to a call error. 



Sequence Element Name 


Sequence Element Type 


ErrorTime 


TpDateAndTime 


ErrorType 


TpCallErrorType 


AdditionalErrorInf o 


TpCallAdditionalErrorlnfo 



6.10 TpCallAdditionalErrorlnfo 



Defines the Tagged Choice of Data Elements that specify additional call error and call error specific 
information. This is also used to specify call leg errors and information errors. 





Tag Element Type 






TpCallErrorType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CALL_ERROR_UNDEFINED 


NULL 


Undefined 


P_CALL_ERROR_INVALID_ADDRESS 


TpAddressError 


CallErrorlnvalidAddress 


P_CALL_ERROR„INVALID_STATE 


NULL 


Undefined 


P_CALL_ERROR_RESOURCE_UNAVAILABLE 


NULL 


Undefined 



6.11 TpCallErrorType 

Defines a specific call error. 



Name 


Value 


Description 


P_CALL_ERROR_UNDEFINED 





Undefined; the method failed or was refused, 
but no specific reason can be given. 


P_CALL_ERROR_INVALID_ADDRESS 


1 


The operation failed because an invalid address 
was given 


P_CALL_ERROR_INVALID_STATE 


2 


The call was not in a valid state for the 
requested operation 


P„CALL_ERROR_RESOURCE_UNAVAILABLE 


3 


There are not enough resources to complete the 
request successfully 
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6.12 TpCalllnfoReport 



Defines the Sequence of Data Elements that specify the call information requested. Information that was not 
requested is invalid. 



Sequence Element Name 


Sequence Element Type 


Description 


CalllnfoType 


TpCalllnfoType 


The type of call report. 


Call InitiationSt art Time 


TpDateAndTime 


The time and date when the call, or 
follow-on call, was started. 


CallConnectedToResourceTime 


TpDateAndTime 


The date and time when the call was 
connected to the resource. 

This data element is only valid when 
information on user interaction is reported. 


CallConnectedToDestinationTime 


TpDateAndTime 


The date and time when the call was 
connected to the destination (i.e., when the 

destination answered the call). If the 

destination did not answer, the time is set 

to an empty string. 

This data element is invalid when 

information on user interaction is reported 

with an intermediate report. 


CallEndTime 


TpDateAndTime 


The date and time when the call or follow- 
on call or user interaction was terminated. 


Cause 


TpReleaseCause 


The cause of the termination. 



A calllnfoReport will be generated at the end of user interaction and at the end of the connection with the associated 
address. This means that either the destination related information is present or the resource related information, but not 
both. 



6.13 TpCalllnfoType 



Defines the type of call information requested and reported. The values may be combined by a logical 'OR' function. 



Name 


Value 


Description 


P_CALL_INFO_UNDEFINED 


OOh 


Undefined 


P_CALL_INFO_TIMES 


Olh 


Relevant call times 


P„CALL_INFO_RELEASE_CAUSE 


02h 


Call release cause 



6.14 TpCallLoadControlMechanism 

Defines the Tagged Choice of Data Elements that specify the applied mechanism and associated parameters. 





Tag Element Type 






TpCallLoadControlMechanismType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CALL_LOAD_CONTROL_PER_INTERVAL 


TpCallLoadControlIntervalRate 


CallLoadControlPer Interval 
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6.15 TpCallLoadControllntervalRate 

Defines the call admission rate of the call load control mechanism used. This data type indicates the interval (in 
milliseconds) between calls that are admitted. 



Name 


Value 


Description 


P„CALL_LOAD„CONTROL_ADMIT_NO_CALLS 





Infinite interval 
(do not admit any calls) 




1- 

60000 


Duration in milliseconds 



6.16 TpCallLoadControlMechanismType 

Defines the type of call load control mechanism to use. 



Name 


Value 


Description 


P_CALL_LOAD_CONTROL_PER_INTERVAL 





admit one call per interval 



6.17 TpCallMonitorMode 



Defines the mode that the call will monitor for events, or the mode that the call is in following a detected event. 



Name 


Value 


Description 


P_CALL_MONITOR_MODE_INTERRUPT 





The call event is intercepted by the call control 
service and call processing is interrupted. The 

application is notified of the event and call 

processing resumes following an appropriate 

API call or network event (such as a call 

release) 


P_CALL_MONITOR_MODE_NOTIFY 


1 


The call event is detected by the call control 
service but not intercepted. The appUcation is 
notified of the event and call processing 
continues 


P_CALL_MONITOR_MODE_DO_NOT_MONITOR 


2 


Do not monitor for the event 



6.18 TpCallNetworkAccessType 



This data defines the bearer capabilities associated with the call. (3G TS 24.002) This information is network operator 
specific and may not always be available because there is no standard protocol to retrieve the information. 



Name 


Value 


Description 


P_CALL_NETWORK_ACCESS_TYPE_UNKNOWN 





Network type information unknown at this time 


P_CALL_NETWORK_ACCESS_TYPE_POT 


1 


POTS 


P_CALL_NETWORK_ACCESS_TYPE_ISDN 


2 


ISDN 


P_CALL_NETWORK_ACCESS_TYPE_DIALUPINTERNET 


3 


Dial-up Internet 


P_CALL_NETWORK_ACCE S S_TYPE_XD SL 


4 


xDSL 


P_CALL_NETWORK_ACCESS_TYPE_WIRELESS 


5 


Wireless 
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6.19 TpCallPartyCategory 



This data type defines the category of a calling party. (Q.763: Calling Party Category / Called Party Category) 



Name 


Value 


Description 


P_CALL_PARTY_CATEGORY_UNKNOWN 





calling party's category unknown at this time 


P„CALL_PARTY_CATEGORY_OPERATOR_F 


1 


operator, language French 


P_CALL_PARTY_CATEGORY_OPERATOR_E 


2 


operator, language English 


P_CALL_PARTY_CATEGORY_OPERATOR_G 


3 


operator, language German 


P_CALL_PARTY_CATEGORY_OPERATOR_R 


4 


operator, language Russian 


P_CALL_PARTY_CATEGORY_OPERATOR_S 


5 


operator, language Spanish 


P_CALL_PARTY_CATEGORY_ORDINARY_SUB 


6 


ordinary calling subscriber 


P_CALL_PARTY_CATEGORY_PRIORITY_SUB 


7 


calling subscriber with priority 


P_CALL_PARTY_CATEGORY_DATA_CALL 


8 


data call (voice band data) 


P_CALL_PARTY_CATEGORY_TEST_CALL 


9 


test call 


P_CALL_P ART Y_CATEGORY_PAYP HONE 


10 


payphone 



6.20 TpCallServiceCode 



Defines the Sequence of Data Elements that specify the service code and type of service code received during 
a call. The service code type defines how the value string should be interpreted. 



Sequence Element Name 


Sequence Element Type 


CallServiceCodeType 


TpCallServiceCodeType 


ServiceCodeValue 


TpString 



6.21 TpCallServiceCodeSet 

Defines a Numbered Set of Data Elements of TpCallServiceCode. 



6.22 TpCallServiceCodeType 

Defines the different types of service codes that can be received during the call. 



Name 


Value 


Description 


P_CALL_SERVICE_CODE_UNDEFINED 





The type of service code is unknown. The corresponding string is 
operator specific. 


P_CALL_SERVI CE_CODE_D I G I T S 


1 


The user entered a digit sequence during the call. The corresponding 
string is an ASCII representation of the received digits. 


P_CALL_SERVICE_CODE_FACILITY 


2 


A facility information element is received. The corresponding string 
contains the faciUty information element as defined in ITU Q.932 


P_CALL_SERVICE_C0DE_U2U 


3 


A user-to-user message was received. The associated string contains 
the content of the user-to-user information element. 


P_CALL_SERVICE_CODE_HOOKFLASH 


4 


The user performed a hookflash, optionally followed by some digits. 

The corresponding string is an ASCII representation of the entered 

digits. 


P_CALL_SERVICE_CODE_RECALL 


5 


The user pressed the register recall button, optionally followed by 

some digits. The corresponding string is an ASCII representation of 

the entered digits. 
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6.23 TpCallSuperviseReport 



Defines the responses from the call control service for calls that are supervised. The values may be combined by a 
logical 'OR' function. 



Name 


Value 


Description 


P_CALL_SUPERVISE_TIMEOUT 


Olh 


The call supervision timer has expired 


P_CALL_SUPERVISE_CALL_ENDED 


02h 


The call has ended, either due to timer expiry 

or call party release. In case the called party 

disconnects but a follow-on call can still be 

made also this indication is used. 


P_CALL_SUPERVISE_TONE_APPLIED 


04h 


A warning tone has been apphed. This is only 

sent in combination with 

P_CALL_SUPERVlSE_TIMEOUT 


P_CALL_SUPERVISE_UI_F INI SHED 


08h 


The user interaction has finished. 



6.24 TpCallSuperviseTreatment 



Defines the treatment of the call by the call control service when the call supervision timer expires. The values may be 
combined by a logical 'OR' function. 



Name 


Value 


Description 


P_CALL_SUPERVISE_RELEASE 


Olh 


Release the call when the call supervision 
timer expires 


P_CALL_SUPERVISE_RESPOND 


02h 


Notify the application when the call 
supervision timer expires 


P_CALL_SUPERVISE_APPLY_TONE 


04h 


Send a warning tone to the originating party 

when the call supervision timer expires. If call 

release is requested, then the call will be 

released following the tone after an 

administered time period 
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6.25 TpCallTeleService 



This data type defines the tele-service associated with the call. (Q.763: User Teleservice Information, Q.931: High 
Layer Compatibility Information, and 3G TS 22.003) 



Name 


Value 


Description 


P_CALL_TELE_SERVICE_UNKNOWN 





Teleservice information unknown at this time 


P_CALL_TELE_SERVICE_TELEPHONY 


1 


Telephony 


P_CALL_TELE_SERVICE_FAX_2_3 


2 


Facsimile Group 2/3 


P_CALL_TELE_SERVICE_FAX_4_I 


3 


Facsimile Group 4, Class I 


P_CALL_TELE_SERVICE_FAX_4_I I_1 1 1 


4 


Facsimile Group 4, Classes II and III 


P_CALL_TELE_SERVICE_VIDEOTEX_SYN 


5 


Syntax based Videotex 


P_CALL_TELE_SERVICE_VIDEOTEX„INT 


6 


International Videotex interworking via gateways or interworking 
units 


P_CALL_TELE_SERVICE_TELEX 


7 


Telex service 


P_CALL_TELE_SERVICE_MHS 


8 


Message Handling Systems 


P_CALL_TELE_SERVICE_OSI 


9 


OSI application 


P_CALL_TELE_SERVICE_FTAM 


10 


FT AM application 


P_CALL_TELE_SERVICE_VIDEO 


11 


Videotelephony 


P_CALL_TELE_SERVICE_VIDEO_CONF 


12 


Videoconferencing 


P_CALL_TELE_SERVICE_AUDIOGRAPH_CONF 


13 


Audiographic conferencing 


P„CALL_TELE_SERVICE_MULTIMEDIA 


14 


Multimedia services 


P_CALL_TELE_SERVICE_CS_INI_H221 


15 


Capability set of initial channel of H.221 


P_CALL_TELE_SERVICE_CS_SUB_H221 


16 


Capability set of subsequent channel of H.221 


P„CALL_TELE_SERVICE_CS_INI_CALL 


17 


Capability set of initial channel associated with an active 3,1 kHz 
audio or speech call. 


P_CALL_TELE_SERVICE_DATATRAFFIC 


18 


Data traffic. 


P_CALL_TELE_SERVICE_EMERGENCY_CALLS 


19 


Emergency Calls 


P_CALL_TELE_SERVICE_SMS_MT_PP 


20 


Short message MT/PP 


P_CALL_TELE_SERVICE_SMS_MO_PP 


21 


Short message MO/PP 


P_CALL_TELE_SERVICE_CELL_BROADCAST 


22 


Cell Broadcast Service 


P_CALL_TELE_SERVICE_ALT_SPEECH_FAX_3 


23 


Alternate speech and facsimile group 3 


P_CALL_TELE_SERVICE_AUT0MATIC_FAX_3 


24 


Automatic Facsimile group 3 


P_CALL_TELE_SERVICE_VOICE_GROUP_CALL 


25 


Voice Group Call Service 


P_CALL_TELE_SERVICE_VOICE_BROADCAST 


26 


Voice Broadcast Service 



6.26 TpCallTreatment 



Defines the Sequence of Data Elements that specify the treatment for calls that will be handled only by the 
network (for example, call which are not admitted by the call load control mechanism). 



Sequence Element Name 


Sequence Element Type 


CallTreatmentType 


TpCallTreatment Type 


ReleaseCause 


TpReleaseCause 


AdditionalTreatmentInf o 


TpCallAdditionalTreatmentlnfo 
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6.27 TpCallTreatmentType 

Defines the treatment for calls that will be handled only by the network. 



Name 


Value 


Description 


P_CALL_TREATMENT_DEFAULT 





Default treatment 


P_CALL_TREATMENT_RELEASE 


1 


Release the call 


P_CALL_TREATMENT_S I AR 


2 


Send information to the user, and release the 
call (Send Info & Release) 



6.28 TpCallAdditionalTreatmentlnfo 

Defines the Tagged Choice of Data Elements that specify the information to be sent to a call party. 





Tag Element Type 






TpCallTreatmentType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_CALL_TREATMENT_DEFAULT 


NULL 


Undefined 


P_CALL_TREATMENT_RELEASE 


NULL 


Undefined 


P_CALL_TREATMENT_S I AR 


TpUIInfo 


Inf ormationToSend 



6.29 TpMediaType 



Defines the media type of a media stream. The values may be combined by a logical 'OR' function. 



Name 


Value 


Description 


P_AUDIO 


1 


Audio stream 


P_VIDEO 


2 


Video stream 


P„DATA 


4 


Data stream (e.g., T.120) 
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Annex A (normative): 

OMG IDL Description of Common Call Control Data Types 

The OMG IDL representation of this specification is contained in the text file common_cc_data.idl (contained in 
archive 291980401IDL.ZIP) which accompanies the present document. 
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Annex B (informative): 

W3C WSDL Description of Common Call Control Data 

Types 

The W3C WSDL representation of this specification is contained in text files (common_cc_data.wsdl contained in 
archive 291980401WSDL.ZIP) which accompanies the present document. 
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Annex C (informative): 

Java API Description of the Call Control SCFs 

The Java API representation of this specification can be obtained from the following URL: 

• Java Call Control ( http ://i cp .org/j sr/de tail/2 1 . i sp ) 

Each JSR webpage contains a table identifying the relationships between the different versions of the Parlay, 
ETSI/OSA, 3GPP/0SA and JAIN SPA specifications. In addition, each JAIN SPA specification version indicates to 
which Parlay, ETSI/OSA and 3GPP/0SA specification versions it corresponds to. 
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